home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / g_man / cat3 / ftn / bbox2.z / bbox2
Encoding:
Text File  |  2002-10-03  |  5.0 KB  |  133 lines
  1.  
  2.  
  3.  
  4. bbbbbbbbooooxxxx2222((((3333GGGG))))                                                            bbbbbbbbooooxxxx2222((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      bbbbbbbbooooxxxx2222,,,, bbbbbbbbooooxxxx2222iiii,,,, bbbbbbbbooooxxxx2222ssss - culls and prunes to bounding box and minimum
  10.      pixel radius
  11.  
  12. FFFFOOOORRRRTTTTRRRRAAAANNNN 77777777 SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  13.      ssssuuuubbbbrrrroooouuuuttttiiiinnnneeee bbbbbbbbooooxxxx2222((((xxxxmmmmiiiinnnn,,,, yyyymmmmiiiinnnn,,,, xxxx1111,,,, yyyy1111,,,, xxxx2222,,,, yyyy2222))))
  14.      iiiinnnntttteeeeggggeeeerrrr****4444 xxxxmmmmiiiinnnn,,,, yyyymmmmiiiinnnn
  15.      rrrreeeeaaaallll xxxx1111,,,, yyyy1111,,,, xxxx2222,,,, yyyy2222
  16.  
  17.      ssssuuuubbbbrrrroooouuuuttttiiiinnnneeee bbbbbbbbooooxxxx2222iiii((((xxxxmmmmiiiinnnn,,,, yyyymmmmiiiinnnn,,,, xxxx1111,,,, yyyy1111,,,, xxxx2222,,,, yyyy2222))))
  18.      iiiinnnntttteeeeggggeeeerrrr****4444 xxxxmmmmiiiinnnn,,,, yyyymmmmiiiinnnn,,,, xxxx1111,,,, yyyy1111,,,, xxxx2222,,,, yyyy2222
  19.  
  20.      ssssuuuubbbbrrrroooouuuuttttiiiinnnneeee bbbbbbbbooooxxxx2222ssss((((xxxxmmmmiiiinnnn,,,, yyyymmmmiiiinnnn,,,, xxxx1111,,,, yyyy1111,,,, xxxx2222,,,, yyyy2222))))
  21.      iiiinnnntttteeeeggggeeeerrrr****4444 xxxxmmmmiiiinnnn,,,, yyyymmmmiiiinnnn
  22.      iiiinnnntttteeeeggggeeeerrrr****2222 xxxx1111,,,, yyyy1111,,,, xxxx2222,,,, yyyy2222
  23.  
  24.      All of the above routines are functionally the same.  They differ only in
  25.      the declaration types of their parameters.
  26.  
  27. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  28.      _x_m_i_n   expects the width, in pixels, of the smallest displayable feature.
  29.  
  30.      _y_m_i_n   expects the height, in pixels, of the smallest displayable
  31.             feature.
  32.  
  33.      _x_1     expects the _x coordinate of a corner of the bounding box.
  34.  
  35.      _y_1     expects the _y coordinate of a corner of the bounding box.
  36.  
  37.      _x_2     expects the _x coordinate of a corner of the bounding box. The
  38.             corner referenced by this parameter must be diagonally opposite
  39.             the corner referenced by the _x_1 and  _y_1 parameters.
  40.  
  41.      _y_2     expects the _y coordinate of a corner of the bounding box. The
  42.             corner referenced by this parameter must be diagonally opposite
  43.             the corner referenced by the _x_1 and  _y_1 parameters.
  44.  
  45. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  46.      bbbbbbbbooooxxxx2222 performs the graphical functions known as _c_u_l_l_i_n_g and _p_r_u_n_i_n_g.
  47.      Culling prevents the system from drawing objects that are less than the
  48.      minimum feature size (_x_m_i_n and _y_m_i_n). Pruning prevents the system from
  49.      drawing objects that lie completely outside the viewport.
  50.  
  51.      To determine whether or not to cull an object, bbbbbbbbooooxxxx2222 tests whether or not
  52.      the display of a rectangle the size of the bounding box is smaller than
  53.      the minimum feature size. To determine whether or not to prune an object,
  54.      bbbbbbbbooooxxxx2222 tests whether or not the bounding box is completely outside the
  55.      viewport.
  56.  
  57.      Call bbbbbbbbooooxxxx2222 within the definition for an object, just after the call to
  58.      mmmmaaaakkkkeeeeoooobbbb.  If the object must be pruned or culled, the remainder of the
  59.      object definition is ignored.
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. bbbbbbbbooooxxxx2222((((3333GGGG))))                                                            bbbbbbbbooooxxxx2222((((3333GGGG))))
  71.  
  72.  
  73.  
  74. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  75.      makeob
  76.  
  77. NNNNOOOOTTTTEEEESSSS
  78.      This routine does not function in immediate mode.
  79.  
  80.      This routine is not a free test.  If you use bbbbbbbbooooxxxx2222 too freely, your
  81.      performance can suffer.  Reserve bbbbbbbbooooxxxx2222 for complicated object definitions
  82.      only.
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.